home *** CD-ROM | disk | FTP | other *** search
/ Shareware Super Platinum 8 / Shareware Super Platinum 8.iso / mac / ARCHIVE / UC2INS.ZIP;1 / MAIN.DOC < prev    next >
Encoding:
Text File  |  1994-01-01  |  31.3 KB  |  828 lines
  1. 4. MAIN: the use of the UC command in detail
  2. ============================================
  3.  
  4. UltraCompressor II (tm) from Ad Infinitum Programs (AIP-NL) is an
  5. archiver. An archiver is a file handling and compression utility. It
  6. will make most of your files significantly smaller and it can keep
  7. related files together. When you need the files, you can decompress
  8. them with the same UC utility. UC is very easy to use, thanks to its
  9. highly developed user interface, and has support for all archiving
  10. needs.
  11.  
  12. You can order UltraCompressor II by filling out the ORDER.FRM and
  13. sending it to Ad Infinitum Programs.
  14.  
  15. One general point about UC is that you can consider an archive in the
  16. same way as you would a disk. It has a root directory, sub-directories
  17. and so on. UC always contains the full directory structure. With UC,
  18. you do not have to deal with 'match path', 'store full path', 'junk
  19. directory name' etc..
  20.  
  21. The file extension of UC archives is currently .UC2. In the future, if
  22. a major new version of UC is released, the extension will become .UC3.
  23. This means that there can be no confusion about which version of UC
  24. should be used.
  25.  
  26. While using UC, the screen will indicate whether everything is working
  27. properly. When errors occur they are shown in detail on the screen and
  28. are also written to an error-log file. When this error-log file grows
  29. over 25,000 bytes, UC will give a warning.
  30.  
  31. In this document all commands/options in the examples given are in
  32. upper case, and parameters are always in lower case. In use, however,
  33. the case is never important. Any mix of upper and lower case can be
  34. used.
  35.  
  36. This document contains the following paragraphs:
  37.  
  38.         - A. Commands/options summary
  39.         - B. Adding files, listing contents
  40.         - C. Extracting files
  41.         - D. Other commands and options
  42.         - E. Version management
  43.         - F. Features and automatics
  44.         - G. Credits
  45.         - H. Acknowledgements
  46.         - Z. Summary
  47.  
  48. To jump to a certain paragraph, press the corresponding letter. To
  49. jump to a specific document/chapter, press the corresponding digit.
  50. See chapter 1 paragraph E for an overview of all documentation.
  51.  
  52.  
  53. 4.A COMMAND/OPTION SUMMARY.
  54. ===========================
  55.  
  56. General: UC command [option(s)] archive-name [files]
  57.  
  58. Starting UC with no commands at all, starts the MANUAL VIEWER and
  59. CONFIGURATION MENU.
  60.  
  61. Commands:
  62. ---------
  63.    A D E     ADD/DELETE/EXTRACT files to/from archive.
  64.              (See paragraph B and C.)
  65.  
  66.    L V       LIST/VERBOSE LIST contents of archive.
  67.  
  68.    P         make archive DAMAGE PROTECTED (approx 1% overhead). Once
  69.              an archive becomes damage protected, it remains damage
  70.              protected, even if it is altered. The P command can be
  71.              combined with other commands (e.g. AP).
  72.  
  73.    U         remove damage protection (if present) from archive.
  74.  
  75.    T         fully TEST archive. When it is damaged, UC will ask if
  76.              it needs to be repaired. In force mode (see options), UC
  77.              will repair without asking.
  78.              If an archive is repaired 100% this is reported. If the
  79.              archive cannot be repaired 100%, the problems (such as
  80.              which files are still damaged, etc.) are reported on
  81.              screen and in the error-log file.
  82.  
  83.    C         CONVERT ZIP, ARC, ARJ etc. archives to UC archives.
  84.              (See chapter 5 paragraph A.)
  85.  
  86.    O         OPTIMIZE archive can make an archive even smaller without
  87.              deleting anything from the archive. Especially if an
  88.              archive has been updated many times and/or contains many
  89.              versions (revisions) of specific files, optimize can
  90.              significantly reduce the size of an archive.
  91.  
  92.    R         REVISE archive comment.
  93.              (See paragraph D.)
  94.  
  95. Options:
  96. --------
  97.    TF TN TT  Type-Fast; Type-Normal (default) or Type-Tight/multimedia
  98.              compression.
  99.  
  100.              In TT mode, UC will detect whether a file is a multimedia
  101.              file. Special (lossless) multimedia compression will then
  102.              take place.
  103.  
  104.              Please note multimedia compression is not able to
  105.              compress already compressed files (e.g. *.GIF or *.JPG
  106.              cannot be significantly compressed).
  107.  
  108.    TST       Type-Super-Tight compresses a bit better that TT
  109.              compression, but takes noticeable more time. Only
  110.              recomended if time is not an issue. TST compression does
  111.              not affect decompression speed, which remains very fast.
  112.  
  113.    S         also process all SUB-DIRECTORIES. By default only the
  114.              files in the current directory are processed.
  115.  
  116.    F         FORCE mode. Using this mode, the program will work
  117.              silently. Almost nothing will be asked during execution.
  118.              In all cases where a question would be asked, the program
  119.              acts as if 'yes' was answered. When not using this mode,
  120.              the program will often ask what you want in case of doubt.
  121.  
  122.                 when NOT in force mode
  123.                 ----------------------
  124.                    - UC will prompt you before overwriting files
  125.                    - UC will prompt you before creating directories
  126.                    - UC will optionally ask if hidden/system files
  127.                      should be processed
  128.                    - UC will optionally ask permission to convert
  129.                      archives
  130.                    - UC will optionally ask permission to show/play
  131.                      multimedia banners
  132.                    - UC will prompt you before repairing a damaged
  133.                      archive (T command)
  134.  
  135.                 when in force mode
  136.                 ------------------
  137.                    - UC will overwrite files without asking
  138.                    - UC will create directories without asking
  139.                    - UC will add hidden/system files (unless
  140.                      the configuration does not allow that)
  141.                    - UC will always apply auto-conversion
  142.                    - UC will show/play multimedia banners (unless
  143.                      the configuration does not allow that)
  144.                    - UC will repair an archive immediately, if
  145.                      the T (test) command finds a problem
  146.  
  147.    I         INCREMENTAL mode, for FAST updates and version control.
  148.              Version control is also called revision management. The
  149.              original archive is not changed, changed files are appended
  150.              to the archive. Previous versions (revisions) of a file
  151.              remain accessible this way (version control).
  152.              (See paragraph E.)
  153.  
  154.    B         BASIC mode (default unless UC is configured otherwise).
  155.              This is the opposite of incremental mode. In basic mode
  156.              UC overwrites files in the archive. No former versions of
  157.              a file are kept in the archive. If there are multiple
  158.              versions of a file only the latest one is overwritten in
  159.              non incremental mode.
  160.  
  161.    !         EXCLUDE file(s).
  162.              (See paragraph B.)
  163.  
  164.    ;n        extract/delete OLDER VERSION of file
  165.              (See paragraph E.)
  166.  
  167.    !DTT=YYYY-MM-DD/HH:MM:SS
  168.              DYNAMIC TIME TRAVEL, option for accessing older versions
  169.              (revisions) of (large) collections of files.
  170.              (See paragraph E.)
  171.  
  172.    #         DESTINATION PATH of files in archive while adding or
  173.              DESTINATION PATH of files on disk while extracting.
  174.              (See paragraphs B and C.)
  175.  
  176.  
  177.    &         CONCATENATION OF COMMANDS.
  178.              (See paragraph D.)
  179.  
  180.    @         specifies a SCRIPT file which substitutes part of the
  181.              command line.
  182.              (See paragraph F.)
  183.  
  184.    !RELIA=   These options allow (temporary) CONFIGURATION of many of
  185.    !ARCON=   the values one can configure with the configuration
  186.    !SMSKIP=  screen. The exact usage of these options is documented
  187.    !BAN=     in chapter 6.
  188.    !VSCAN=
  189.    !SOS2EA=  Example: UC A -S !SYSHID=ON arch *.*
  190.    !NET=
  191.    !SYSHID=  In this example hidden and system files are also added to
  192.              the archive.
  193.  
  194.  
  195. 4.B ADDING FILES, LISTING CONTENTS.
  196. ===================================
  197.  
  198. Examples:
  199.  
  200.    UC A arch *.cpp
  201.       All *.cpp files in the current directory are compressed into the
  202.       archive arch.uc2. If the archive already exists, the files are
  203.       added to the archive.
  204.  
  205.  
  206.    UC A -TF docs *.* !*.bak
  207.       All (*.*) files except *.bak files are (RAPIDLY) compressed into
  208.       the archive docs.uc2.
  209.  
  210.    UC A -S a:\back c:\doc\*.*
  211.       Create/update archive of complete directory with its
  212.       subdirectories to archive back.uc2 in the root directory of
  213.       drive A:.
  214.  
  215.    When the files to be added are specified with *.*, the command can
  216.    be shortened: 'c:\doc\*.*' can be replaced by 'c:\doc\'.
  217.  
  218.    UC A arch #\dir1 *.cpp
  219.       Move all .cpp files from the current directory to directory
  220.       dir1 in the archive arch.uc2. When a subdirectory does not
  221.       already exist in the archive, UC will ask you if it has to be
  222.       created in the archive.
  223.  
  224.    UC L arch
  225.       List contents of root directory of arch.uc2 without
  226.       subdirectories.
  227.  
  228.    UC V arch
  229.       Verbose list contents of arch.uc2 without subdirectories. Not
  230.       only the files are shown, but also all the versions of the
  231.       files, with date and time of last update.
  232.  
  233.    UC L -S arch
  234.       List contents of all directories and subdirectories in arch.uc2
  235.  
  236. Possible alternative ways to enter commands
  237. -------------------------------------------
  238.    Options can be put directly after the command or after the previous
  239.    option (no space allowed) or they can be prefixed by '-' or '/'.
  240.  
  241.    Some example alternatives for 'UC A -S -TF docs *.* !*.bak':
  242.  
  243.       UC  A -STF docs *.* !*.bak
  244.  
  245.          You can concatenate options.
  246.  
  247.       UC  ASTF docs *.* !*.bak
  248.  
  249.          You can append the options directly to the command.
  250.  
  251.       UC  -A -S -TF docs *.* !*.bak
  252.  
  253.          It is allowed to preceed the command with an '-'.
  254.  
  255.       UC  A /S /TF docs *.* !*.bak
  256.  
  257.          UC does not care wether you use '-' or '/'.
  258.  
  259.       UC  A -S -TF docs !*.bak
  260.  
  261.          If no file specifications are present, UC uses *.*.
  262.  
  263.  
  264. If you want an archive with a name without extension, type a '.' just
  265. after the archive name:
  266.  
  267.    UC A sources. *.*
  268.       The archive will become 'sources' instead of 'sources.uc2'.
  269.  
  270.  
  271. 4.C EXTRACTING FILES.
  272. =====================
  273.  
  274. Examples:
  275.  
  276.    UC E sources *.cpp
  277.       Extract all *.cpp files from sources.uc2 into the current
  278.       directory.
  279.  
  280.    UC E backup \test\test.cpp
  281.       Extract test.cpp from subdirectory test in the archive, into
  282.       the current directory.
  283.  
  284.    UC E -S backup \test\*.*
  285.       Extract contents of the archive's directory test and all its
  286.       subdirectories, into the current directory.
  287.  
  288.    UC E -S backup *.cpp #\dir1
  289.       Extract contents of the archive's directory test and all its
  290.       subdirectories into the directory \dir1.
  291.  
  292.    When a directory does not exist, UC will ask you if it has to be
  293.    created.
  294.  
  295.    UC D arch *.bak
  296.       Delete all *.bak files from the archive.
  297.  
  298.    UC D arch *.* !*.dbf !*.ntx
  299.       Delete all files except *.dbf and *.ntx files from the archive.
  300.  
  301.  
  302. 4.D OTHER COMMANDS AND OPTIONS.
  303. ===============================
  304.  
  305. Examples:
  306.  
  307.    UC T arch
  308.       Thoroughly test arch.uc2, and if it turns out to be damaged,
  309.       prompt the user for reparation of the archive.
  310.  
  311.       In case the archive is repaired, a new archive is created with
  312.       the name FIX_xxxx.UC (xxxx stands for the sequence number of
  313.       existing FIX files), the original arch.uc2 remains unchanged.
  314.  
  315.    UC P arch
  316.       Makes arch.uc2 damage protected.
  317.  
  318.    UC U arch
  319.       Remove damage protection from arch.uc2.
  320.  
  321.    UC C arch.arj  or
  322.    UC C arch.zip  or
  323.    UC C arch.lzh  etc.
  324.       An archive made with another archiver will be converted to a
  325.       UC archive. The extension (e.g. zip, arj) is optional; UC will
  326.       read 'UC C arch' as 'UC C arch.*'.
  327.  
  328.       Note: be sure the other archiver you need is in a directory
  329.       named in the PATH statement of your AUTOEXEC.BAT.
  330.  
  331.  
  332.    UC A one *.bat & A -S world *.bak & E -S execs *.exe & A world *.cmd
  333.       With '&' multiple commands can be given at once.
  334.  
  335.       In this command all the .bat files from the current directory are
  336.       added to one.uc2, all the .bak files from the current directory
  337.       and all its subdirectories are added to world.uc2, all the .exe
  338.       files from the archive (including subdirectories) are extracted
  339.       from execs.uc2 and all the .cmd files from the current directory
  340.       are added to world.uc2.
  341.  
  342.    For long commands we advise you to use '@'.
  343.    (See paragraph F.)
  344.  
  345.    UC R arch
  346.       With your favourite editor you can view or edit the comment file
  347.       in the archive arch.
  348.  
  349.       Note: be sure your U2_EDIT.BAT file is accessible and contains
  350.       your favourite editor.
  351.       (See chapter 6 paragraph D.)
  352.  
  353.  
  354. 4.E VERSION MANAGEMENT.
  355. =======================
  356.  
  357. When you want to keep the former versions (revisions) of a file in
  358. the archive, you can use the -I option to activate 'incremental mode'.
  359.  
  360. You can use the -B option, to activate 'basic mode', when you do not
  361. want to keep the older versions of a file in the archive.
  362.  
  363. In the configuration screen (see also chapter 6) it is possible to
  364. change the default mode from basic mode to incremental mode or vice
  365. versa.
  366.  
  367. In the next examples the default mode of UC is basic:
  368.  
  369.    UC A -I -S a:\back c:\docs\*.*
  370.       Incrementally update an archive (a:\back.uc2)
  371.  
  372.    UC E arch filename.doc
  373.       Extracts the most recent version of the file 'filename.doc'
  374.       from arch.uc2.
  375.  
  376.    UC E arch filename.doc;n
  377.       Extracts the requested version of the file 'filename.doc'.
  378.       'n' represents the number of the version.
  379.  
  380. Some explanation about 'n':
  381. ---------------------------
  382.    Different versions of the same file in the archive get a sequence
  383.    number.
  384.  
  385.    The most recent version gets number 0. The oldest version gets the
  386.    highest number. Every time the same file is added to the archive in
  387.    incremental mode, to remain consistent, all versions get a new
  388.    number.
  389.  
  390.    There is no practical limit to the number of versions of a file you
  391.    can keep in an archive.
  392.  
  393. Now we will look at an archive arch.uc2 after completion of some
  394. operations:
  395.  
  396.    UC A -I arch test.doc
  397.       The file test.doc is added to the archive arch.uc2. This is the
  398.       first operation on the archive, so it contains only test.doc.
  399.  
  400.    UC V arch
  401.       The verbose list of arch.uc2 shows us:
  402.         TEST    DOC        1234      MAR-17-1993  12:24:12
  403.        (name    ext nr     length    date         time)
  404.  
  405. After changing the file test.doc, we add it again to arch.uc2:
  406.  
  407.    UC A -I arch test.doc
  408.       The second version of the same file is added to arch.uc2. The
  409.       archive now contains two files:
  410.  
  411.    UC V arch
  412.       The verbose list of arch.uc2 shows us:
  413.         TEST    DOC;0      1245      MAR-17-1993  12:26:26
  414.         TEST    DOC;1      1234      MAR-17-1993  12:24:12
  415.        (name    ext nr     length    date         time)
  416.  
  417. After adding some more versions of the file TEST.DOC, the verbose
  418. list gives:
  419.  
  420.    UC V arch
  421.         TEST    DOC;0      1356      MAR-17-1993  14:02:00
  422.         TEST    DOC;1      1349      MAR-17-1993  13:50:56
  423.         TEST    DOC;2      1298      MAR-17-1993  13:28:32
  424.         TEST    DOC;3      1280      MAR-17-1993  13:15:42
  425.         TEST    DOC;4      1245      MAR-17-1993  12:26:26
  426.         TEST    DOC;5      1234      MAR-17-1993  12:24:12
  427.  
  428. Now there are six different versions in the archive of the same file
  429. TEST.DOC.
  430. When you want to extract the most recent one, type the next command:
  431.  
  432.    UC E arch test.doc    or
  433.    UC E arch test.doc;0
  434.       The most recent version of TEST.DOC is extracted from arch.uc2.
  435.  
  436. When you want to see another version you have to include the version
  437. number in the command:
  438.  
  439.    UC E arch test.doc;3
  440.       There are three more recent versions in the archive than the
  441.       version extracted.
  442.  
  443. (Of course the archive is unchanged after extracting a file.)
  444.  
  445. Deleting a version from the archive is possible with the next command:
  446.  
  447.    UC D arch test.doc
  448.       The most recent version of the file is deleted from arch.uc2.
  449.  
  450. The verbose list will give the next information:
  451.  
  452.    UC V arch
  453.         TEST    DOC;0      1349      MAR-17-1993  13:50:56
  454.         TEST    DOC;1      1298      MAR-17-1993  13:28:32
  455.         TEST    DOC;2      1280      MAR-17-1993  13:15:42
  456.         TEST    DOC;3      1245      MAR-17-1993  12:26:26
  457.         TEST    DOC;4      1234      MAR-17-1993  12:24:12
  458.  
  459. Also an older version of the file can be deleted:
  460.  
  461.    UC D arch test.doc;2
  462.  
  463. The verbose list will give the next information:
  464.  
  465.    UC V arch
  466.         TEST    DOC;0      1349      MAR-17-1993  13:50:56
  467.         TEST    DOC;1      1298      MAR-17-1993  13:28:32
  468.         TEST    DOC;2      1245      MAR-17-1993  12:26:26
  469.         TEST    DOC;3      1234      MAR-17-1993  12:24:12
  470.  
  471. When you want to remove the total file TEST.DOC with all its versions
  472. from the archive you type the following command:
  473.  
  474.    UC D arch test.doc;*
  475.  
  476. When you want to remove all the older versions from the archive but
  477. keep the most recent one, you type:
  478.  
  479.    UC D arch test.doc;* !test.doc     or
  480.    UC D arch test.doc;* !test.doc;0
  481.  
  482. When the archive contains more files with different versions and you
  483. only want to keep the most recent version of these files, you type:
  484.  
  485.    UC D arch *.*;* !*.*       or
  486.    UC D arch *.*;* !*.*;0
  487.  
  488. As you can see in the examples, for the most recent version of a
  489. file, you can just type the file name without number, or the filename
  490. with ';0'.
  491.  
  492. Dynamic Time Travel (!DTT=YYYY-MM-DD/HH:MM:SS)
  493. ----------------------------------------------
  494.    Time travel simulates the status of the archive, as it was at the
  495.    specified moment in the past.
  496.  
  497.    The above explanation and samples work excellently for a small
  498.    amount of files, but not when large collections of files, all with
  499.    many versions, are involved. For this the 'Dynamic Time Travel'
  500.    option is the perfect solution.
  501.  
  502.    Time travel is only available for the extract (E) and the list (L
  503.    and V) commands. Its syntax is !DTT=YYYY-MM-DD/HH:MM:SS with YYYY
  504.    being the year (e.g. 1993), MM being the month, DD being the day,
  505.    HH being the hour (e.g. 21), MM minute, SS second. The year MUST be
  506.    4 digits, all other numbers MUST be two digits.
  507.  
  508.    You can supply only the left part of the arguments, UC will fill in
  509.    the rest:
  510.  
  511.    e.g. !DTT=1993-03-17 will be expanded to 1993-03-17/00:00:00
  512.         !DTT=1991 will be expanded to 1991-01-01/00:00:00
  513.         !DTT=1992-01-22/18 will be expanded to 1992-01-22/18:00:00
  514.  
  515.    Please note the -/:'s are optional, e.g. !DTT=19930317 can be used
  516.    instead of !DTT=1993-03-17. (Actually UC ignores the -/:'s
  517.    completely, their only purpose is to make the entered command more
  518.    readable.)
  519.  
  520.    For the next two examples, assume the archive contains:
  521.  
  522.       TEST    DOC;0      1349      MAR-17-1993  13:50:56
  523.       TEST    DOC;1      1298      MAR-17-1993  13:28:32
  524.       TEST    DOC;2      1280      MAR-17-1993  13:15:42
  525.       TEST    DOC;3      1245      MAR-17-1993  12:26:26
  526.       TEST    DOC;4      1234      MAR-17-1993  12:24:12
  527.  
  528.    An example:
  529.       UC E !DTT=1993-03-17/13:30 arch test.doc
  530.  
  531.    In this case a 'time travel' to 17 march 1993, 13:30 is executed.
  532.    Since at that moment the 13:28:32 version of test.doc was the one
  533.    last added to the archive, THAT version will be extracted.
  534.  
  535.    Another example:
  536.       UC V !DTT=1993-03-17/13:20 arch
  537.  
  538.         TEST    DOC;0      1280      MAR-17-1993  13:15:42
  539.         TEST    DOC;1      1245      MAR-17-1993  12:26:26
  540.         TEST    DOC;2      1234      MAR-17-1993  12:24:12
  541.  
  542.    Note two versions have 'disappeared' and all other versions have
  543.    got a new index.
  544.  
  545.    Please note Dynamic Time Travel NEVER alters the contents of
  546.    an archive, it only creates a different viewpoint.
  547.  
  548. Important note
  549. --------------
  550.    Especially where an archive has been updated many times and
  551.    contains many versions of specific files, optimize can
  552.    significantly reduce the size of an archive.
  553.  
  554.    A just optimized archive, which contains multiple versions of
  555.    files, will often be only a little bit larger than an archive which
  556.    contains only the last version of all files.
  557.  
  558.  
  559. 4.F FEATURES AND AUTOMATICS.
  560. ============================
  561.  
  562. Many advanced features are automatic in UC. The following topics are
  563. covered in this paragraph:
  564.  
  565.    - Smart skipping
  566.  
  567.    - Superior error handling
  568.    - Superior control-break handling
  569.    - Ensure mode
  570.    - Crash management
  571.  
  572.    - Auto-Conversion of other archives
  573.    - Virus scan during conversion
  574.  
  575.    - Script files
  576.    - Wildcards in archives specification
  577.  
  578.    - OS/2 2.x extended attributes
  579.    - Multimedia banners
  580.  
  581. Smart skipping
  582. --------------
  583.    Smart skipping means: Do not do unnecessary things. While updating
  584.    an archive, files can be changed or not. Unchanged files will be
  585.    skipped, when smart skipping is on. This makes updating faster.
  586.  
  587.    In the configuration, smart skipping can be on or off. UC compares
  588.    filename, filesize, file time and file date.
  589.  
  590. Superior error handling
  591. -----------------------
  592.    No matter how deep UC gets into trouble, it will handle everything
  593.    with grace.
  594.  
  595.    UC allows you not only to notice the error but also to do whatever
  596.    is needed (including going to DOS!) to solve the problem. UC does
  597.    not just stop, undoing all the work it has already done for you.
  598.    E.g. when a floppy turns out to be write protected, you can remove
  599.    the write protection and continue UC.
  600.  
  601. Superior control-break handling
  602. -------------------------------
  603.    When you interrupt UC, you do not just stop it, cancelling all
  604.    valuable work you have done. Instead, you are given the opportunity
  605.    to go to DOS to do whatever you like (after which UC can continue
  606.    where it left off). You can of course also abort the program.
  607.  
  608.    If you press control-break while UC is adding files to an archive,
  609.    you get an extra option which allows you to skip all pending
  610.    additions. All additions already performed, remain in the archive.
  611.    (Since smart-skipping will automatically skip files which are
  612.    already in the archive (when unchanged), you can continue the
  613.    interrupted command later.)
  614.  
  615. Ensure mode
  616. -----------
  617.    For those who need absolute reliability, e.g. mission critical data
  618.    compression tasks, UC has an ENSURE operation mode. In this mode UC
  619.    handles all updates to an archive as transactions. A transaction
  620.    can only be confirmed if PROOF has been gathered that the
  621.    transaction was completed 100% without problems. When a problem has
  622.    occurred, irrespective of the cause, e.g. hardware failures,
  623.    software conflicts, they will never get by unnoticed and the
  624.    operation can be reversed.
  625.  
  626. Crash management
  627. ----------------
  628.    When adding files to an archive in basic mode, crashes can do no
  629.    harm, because UC works with a temporary file. Only when everything
  630.    has been completed successfully will the temporary file, which
  631.    contains the new archive, be copied to the archive file. To prevent
  632.    data loss while adding files to an archive in incremental mode, UC
  633.    creates a new file with recovery information of the archive. This
  634.    file is called arch.UR2 (UltraRecover).
  635.  
  636.    When everything goes right, this .UR2 file will be deleted
  637.    automatically and you will never notice it ever existed. But when
  638.    your computer crashes during adding files to the archive in
  639.    incremental mode, this .UR2 file will mostly still exist after the
  640.    crash.
  641.  
  642.    If you try to do anything with the archive now, you will get a
  643.    message to repair the archive with 'UC T'. After the repair, the
  644.    files arch.UC2 and arch.UR2 will still exist. The repaired archive
  645.    is stored in the file named FIX_xxxx.UC2 (xxxx stands for the
  646.    sequence number of existing FIX files). Before you can use the
  647.    archive again, you have to move FIX_xxxx.UC2 to arch.UC2 and delete
  648.    the file arch.UR2. Now the situation is similar to the one before
  649.    the crash.
  650.  
  651. Auto-Conversion of other archives
  652. ---------------------------------
  653.    Archives made by other archivers can be converted by UC. The
  654.    automatic conversion can be set ON in the configuration (see also
  655.    chapter 6 paragraph A option D).
  656.  
  657.    Adding a file to the archive or any other operation on it, starts
  658.    automatically with the conversion of it. It is important to know
  659.    that, when using an archive made with another archiver, you have to
  660.    type the archive name with the extension (e.g. arch.zip, arch.arj).
  661.  
  662.    Note: be sure the other archiver you need is in a directory named
  663.    in the PATH of your AUTOEXEC.BAT.
  664.  
  665. Virus scan during conversion
  666. ----------------------------
  667.    The archive to be converted can be optionally scanned for virusses.
  668.    In the configuration this virus scanning can be switched ON or OFF.
  669.    In the batch file U2_CHECK.bat some virus scanners are called. Make
  670.    sure you have those virus scanners on your disk, in a directory named
  671.    in the PATH of your AUTOEXEC.BAT.
  672.  
  673.    You can change the batch file and use different virus scanners (see
  674.    chapter 6 paragraph D).
  675.  
  676. Script files
  677. ------------
  678.    A 'script' file can contain a large list of files (e.g. to be
  679.    compressed). A script file can also be used as a substitute for
  680.    multiple (complex) commands. Script files can be nested, to allow
  681.    the construction of 'building blocks'. Script files can be
  682.    extremely long (multi-megabyte).
  683.  
  684.    UC @exam
  685.       The contents of 'exam': A arch *.bat & V arch
  686.       The .bat files are added to the archive arch.uc2 followed by a
  687.       verbose list of arch.uc2.
  688.  
  689.       In this example multiple commands are concatenated by '&'.
  690.  
  691.    UC A arch @names
  692.       The contents of 'names': *.bat *.cpp *.doc
  693.       The .bat, .cpp and .doc files are added to the archive arch.uc2.
  694.       In this example the files to be added are substituted by 'names'.
  695.  
  696.    UC @toback *.cpp
  697.       The contents of 'toback': A c:\back
  698.       All .cpp files are added to c:\back.uc2.
  699.  
  700. Wildcards in archives specification
  701. -----------------------------------
  702.    Instead of adding a file or a group of files to different archives
  703.    in different commands, it is possible to work with wildcards.
  704.  
  705.    UC V *
  706.       Gives the verbose list of all the archives at once.
  707.  
  708.    UC A * filename
  709.       The file 'filename' will be added to all the UC archives in the
  710.       current directory. Using a wildcard is the only way to access
  711.       more archives in one command. Only one archive description is
  712.       allowed in a command.
  713.  
  714.    UC A * *.cpp *.bas
  715.       Of course more wildcards may be used for the files to be added.
  716.       All .cpp and .bas files will be added to all archives in the
  717.       current directory.
  718.  
  719.    The commands P, U, T, O and C accept multiple archive
  720.    specifications. Here the archive specification cannot be confused
  721.    with the files specification because there is none.
  722.  
  723.    UC C *.zip *.arj *.lzh
  724.       All zip, arj and lzh archives will be converted.
  725.  
  726. OS/2 2.x extended attributes
  727. ----------------------------
  728.    When the option 'Store OS/2 2.x extended attributes' (see chapter
  729.    6 paragraph A) is active, UC gets the capability to store OS/2
  730.    extended attributes. For example if you attach an icon to a file,
  731.    compress it and extract it somewhere else, the file will still have
  732.    its icon. Of course this is only possible on an OS/2 machine. When
  733.    you extract a file from an archive, the extended attributes will be
  734.    the same as when you put the file in the archive. An archive
  735.    optimized on a machine without extended attribute support (e.g. a
  736.    plain DOS machine) will still contain extended attributes.
  737.  
  738. Multimedia banners
  739. ------------------
  740.    Music, graphics and text banners can be added to an archive.
  741.    (See chapter 5 paragraph B.)
  742.  
  743.  
  744. 4.G CREDITS.
  745. ============
  746.  
  747. Ad Infinitum Programs would like to thank the following people for
  748. their involvement, work, support, idea's, testing, checking, etc. etc.:
  749.  
  750.    Ad Nuhn                          Jan van Leeuwen
  751.    Ad Spijkers                      Jan-Willem Overbeek
  752.    Allen Koberg                     Jean-loup Gailly
  753.    Andrew Cadach                    Jeroen Hoppenbrouwers
  754.    Andy Hakim                       Joe Emenaker
  755.    Arjan Bosse                      Joergen Hjort
  756.    Arno Haket                       Joost Pruijt
  757.    Bernardo Javier Siu Fabry        Kai Uwe Rommel
  758.    Bruus Antonides                  Leonid Yakovlev
  759.    Conny de Vries                   Leslie Klieb
  760.    Danny Bezemer                    Marc de Boer
  761.    Dirk Schrieb                     Marijke Hoytink
  762.    Doug Lamb                        Mark Adler
  763.    Doug Tooley                      Mark Kovarski
  764.    Ellen de Vries                   Mike Charnock
  765.    Eric Morel                       Mike Davis
  766.    Eric Veldhuyzen                  Mike McCombs
  767.    Fabian Meuller                   Nico de Vries
  768.    Forrest Aldrich                  Paul Kocher
  769.    Frank Leene                      Peter Oudenhoven
  770.    Fred Snijder                     Piet van Oostrum
  771.    Fred Wijshoff                    Rafael Ramirez
  772.    Glenn Evan Copeland              Rianne van Leur
  773.    Graeme Cross                     Richard Foster-Dingley
  774.    Greg Roelofs                     Robert Lindeman
  775.    Gregory Flint                    Ronald Raymond Dippold
  776.    Hans Klunder                     Ryan Watkins
  777.    Hans Peer                        Sjuck Brongersma
  778.    Helen Derks                      Stefan Hermansson
  779.    Ian Spenser Nelson               Thomas Wolff
  780.    Ingrid Foster-Dingley-Groot      Timothy F. Sipples
  781.    Jan-Pieter Cornet                Willem Verloop
  782.    Jan van Hees
  783.  
  784. We especially want to thank YOU, the reader of this manual, for
  785. considering the use of our products.
  786.  
  787. Help us to make this product even better. Tell us what you want us to
  788. improve in UC and all our other products. AIP-NL applications are
  789. always designed in close cooperation with the people who use them.
  790. Comment on the manuals in general, or on a manual in a specific
  791. language, is also very welcome.
  792.  
  793.  
  794. 4.H ACKNOWLEDGEMENTS.
  795. =====================
  796.  
  797. Naming or not naming of specific products in the manuals is
  798. non-intentional.
  799.  
  800. UltraCompressor II is a trademark of Ad Infinitum Programs (AIP-NL).
  801.  
  802. Most mentioned brand and product names are trademarks or registered
  803. trademarks of their respective companies.
  804.  
  805.  
  806. 4.Z SUMMARY.
  807. ============
  808.  
  809. UC command [option(s)] archive-name [files]
  810.  
  811. COMMANDS: A D E   add / delete / extract
  812.             L V   list / verbose list
  813.             P U   damage protect / unprotect
  814.               T   test (& repair)
  815.               C   convert archive to .UC2 archive
  816.               O   optimize (especially with many versions of files)
  817.               R   revise archive comment
  818.  
  819. OPTIONS: (directly after command, or preceded by '-' or '/')
  820.        TF TN TT   fast / normal / tight-multimedia
  821.               S   include subdirectories
  822.               F   force mode (never ask, always yes)
  823.             I B   incremental mode (keep versions) / basic mode
  824.  
  825. ;n  specify version      !DTT=YYYY-MM-DD/HH:MM:SS  dynamic time travel
  826.  
  827. ! exclude files    # destination    & concat commands    @ script file
  828.